From 8999053b5f931a8cee054fbc3abaf1edbd5b19a1 Mon Sep 17 00:00:00 2001 From: =?utf8?q?Javier=20Jard=C3=B3n?= Date: Fri, 22 Oct 2010 17:56:00 +0200 Subject: [PATCH] docs: Add gtk-doc notation to emphasize that GtkMisc and GtkAdjustment are not encouraged in new code --- docs/reference/gtk/tmpl/gtkmisc.sgml | 2 ++ gtk/gtkalignment.c | 4 ++++ 2 files changed, 6 insertions(+) diff --git a/docs/reference/gtk/tmpl/gtkmisc.sgml b/docs/reference/gtk/tmpl/gtkmisc.sgml index 57ab5c7090..c9016e2b0f 100644 --- a/docs/reference/gtk/tmpl/gtkmisc.sgml +++ b/docs/reference/gtk/tmpl/gtkmisc.sgml @@ -19,11 +19,13 @@ positioned within its allocated area. Note that if the widget is added to a container in such a way that it expands automatically to fill its allocated area, the alignment settings will not alter the widgets position. + Note that the desired effect can in most cases be achieved by using the #GtkWidget:halign, #GtkWidget:valign and #GtkWidget:margin properties on the child widget, so GtkMisc should not be used in new code. + diff --git a/gtk/gtkalignment.c b/gtk/gtkalignment.c index b3e0b85c79..d8b3fec570 100644 --- a/gtk/gtkalignment.c +++ b/gtk/gtkalignment.c @@ -42,9 +42,13 @@ * Of course, if the scale settings are both set to 1, the alignment settings * have no effect. * + * + * * Note that the desired effect can in most cases be achieved by using the * #GtkWidget:halign, #GtkWidget:valign and #GtkWidget:margin properties * on the child widget, so #GtkAlignment should not be used in new code. + * + * */ #include "config.h" -- 2.30.2